Skip to content

feat: add @superdoc-dev/create package for agent scaffolding - #2533

Merged
caio-pizzol merged 3 commits into
mainfrom
caio/sd-2258-add-superdoc-init-cli-command-for-agent-scaffolding
Mar 23, 2026
Merged

feat: add @superdoc-dev/create package for agent scaffolding#2533
caio-pizzol merged 3 commits into
mainfrom
caio/sd-2258-add-superdoc-init-cli-command-for-agent-scaffolding

Conversation

@caio-pizzol

@caio-pizzol caio-pizzol commented Mar 23, 2026

Copy link
Copy Markdown
Contributor

Summary

New @superdoc-dev/create package. Interactive setup for SuperDoc projects.

npx @superdoc-dev/create

Detects framework, writes AGENTS.md, installs skills, prints MCP instructions. Separate from the document CLI.

Test plan

  • 19 unit tests pass (cd apps/create && bun test)
  • All 7 frameworks detected and templated correctly
  • Non-interactive mode (-y) and --force overwrite work

@linear

linear Bot commented Mar 23, 2026

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

πŸ’‘ Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f3cca611bf

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with πŸ‘.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread apps/cli/src/commands/init-templates.ts Outdated
Comment thread apps/cli/src/commands/init-templates.ts Outdated
Comment thread apps/create/src/templates.ts
@caio-pizzol
caio-pizzol enabled auto-merge (squash) March 23, 2026 21:28
@caio-pizzol
caio-pizzol disabled auto-merge March 23, 2026 21:40
@caio-pizzol
caio-pizzol force-pushed the caio/sd-2258-add-superdoc-init-cli-command-for-agent-scaffolding branch from 67982c4 to 4b7162c Compare March 23, 2026 21:51
@caio-pizzol caio-pizzol changed the title feat(cli): add superdoc init command for agent scaffolding SD-2258 (SD-2258) feat: add @superdoc-dev/create package for agent scaffolding Mar 23, 2026
SD-2258: Standalone interactive setup tool β€” separate from the
document CLI. Detects framework, generates AGENTS.md with tailored
code examples, creates CLAUDE.md symlink, installs skills, and
prints MCP setup instructions.

Supports: React, Next.js (use client), Vue, Nuxt (ClientOnly),
Angular, Svelte, vanilla JS. Interactive agent tool selection
(Claude Code, Cursor, Windsurf) or non-interactive with -y flag.

19 tests covering framework detection, template generation, and
API correctness.
- publishConfig with public access
- .releaserc.cjs following MCP pattern (stable/next channels, Linear
  integration, AI release notes)
- release-create.yml workflow: triggers on apps/create/** changes,
  builds, tests, then releases via semantic-release
- Tag format: create-v${version}
@caio-pizzol
caio-pizzol force-pushed the caio/sd-2258-add-superdoc-init-cli-command-for-agent-scaffolding branch from 2e5392f to 2fa01b9 Compare March 23, 2026 22:59
@caio-pizzol
caio-pizzol enabled auto-merge (squash) March 23, 2026 23:06
@caio-pizzol
caio-pizzol merged commit 61da0f1 into main Mar 23, 2026
3 checks passed
@caio-pizzol
caio-pizzol deleted the caio/sd-2258-add-superdoc-init-cli-command-for-agent-scaffolding branch March 23, 2026 23:23
@superdoc-bot

superdoc-bot Bot commented Mar 23, 2026

Copy link
Copy Markdown
Contributor

πŸŽ‰ This PR is included in @superdoc-dev/create v0.1.0-next.1

The release is available on GitHub release

caio-pizzol added a commit that referenced this pull request Mar 23, 2026
* feat: add @superdoc-dev/create package for agent scaffolding

SD-2258: Standalone interactive setup tool β€” separate from the
document CLI. Detects framework, generates AGENTS.md with tailored
code examples, creates CLAUDE.md symlink, installs skills, and
prints MCP setup instructions.

Supports: React, Next.js (use client), Vue, Nuxt (ClientOnly),
Angular, Svelte, vanilla JS. Interactive agent tool selection
(Claude Code, Cursor, Windsurf) or non-interactive with -y flag.

19 tests covering framework detection, template generation, and
API correctness.

* chore(create): add semantic release, publish config, and CI workflow

- publishConfig with public access
- .releaserc.cjs following MCP pattern (stable/next channels, Linear
  integration, AI release notes)
- release-create.yml workflow: triggers on apps/create/** changes,
  builds, tests, then releases via semantic-release
- Tag format: create-v${version}

* chore(create): set version to 0.0.0 β€” semantic release manages versioning
caio-pizzol added a commit that referenced this pull request Mar 23, 2026
* fix: relax yjs peer dependency from exact pin to range

* ci: trigger release workflows on pnpm-workspace.yaml changes

* chore: regenerate lockfile after yjs catalog range change

* fix: trigger patch release for yjs peer dependency range change

* fix: add comment to yjs catalog entry for clarity

* fix: include pnpm-workspace.yaml in semantic-release commit filters

* chore(cli): 0.3.1 [skip ci]

## [0.3.1](cli-v0.3.0...cli-v0.3.1) (2026-03-23)

### Bug Fixes

* add comment to yjs catalog entry for clarity ([62ae60b](62ae60b))
* include pnpm-workspace.yaml in semantic-release commit filters ([c9f54cc](c9f54cc))
* relax yjs peer dependency from exact pin to range ([45ea510](45ea510))

* fix: retrigger release for yjs peer dependency range change

* chore(release): 1.21.1 [skip ci]

## [1.21.1](v1.21.0...v1.21.1) (2026-03-23)

### Bug Fixes

* add comment to yjs catalog entry for clarity ([62ae60b](62ae60b))
* include pnpm-workspace.yaml in semantic-release commit filters ([c9f54cc](c9f54cc))
* relax yjs peer dependency from exact pin to range ([45ea510](45ea510))
* retrigger release for yjs peer dependency range change ([4e9fdc0](4e9fdc0))

* fix: retrigger CLI release after push race condition

* chore(cli): 0.3.2 [skip ci]

## [0.3.2](cli-v0.3.1...cli-v0.3.2) (2026-03-23)

### Bug Fixes

* retrigger CLI release after push race condition ([9e6cf5e](9e6cf5e))
* retrigger release for yjs peer dependency range change ([4e9fdc0](4e9fdc0))

* feat: add @superdoc-dev/create package for agent scaffolding (#2533)

* feat: add @superdoc-dev/create package for agent scaffolding

SD-2258: Standalone interactive setup tool β€” separate from the
document CLI. Detects framework, generates AGENTS.md with tailored
code examples, creates CLAUDE.md symlink, installs skills, and
prints MCP setup instructions.

Supports: React, Next.js (use client), Vue, Nuxt (ClientOnly),
Angular, Svelte, vanilla JS. Interactive agent tool selection
(Claude Code, Cursor, Windsurf) or non-interactive with -y flag.

19 tests covering framework detection, template generation, and
API correctness.

* chore(create): add semantic release, publish config, and CI workflow

- publishConfig with public access
- .releaserc.cjs following MCP pattern (stable/next channels, Linear
  integration, AI release notes)
- release-create.yml workflow: triggers on apps/create/** changes,
  builds, tests, then releases via semantic-release
- Tag format: create-v${version}

* chore(create): set version to 0.0.0 β€” semantic release manages versioning

* fix: resolve merge conflicts for stable β†’ main sync

Take CLI version 0.3.2 from stable, keep main's newer lockfile deps
(rollup 4.60.0, ajv 8.18.0, openapi-types with patch hash).

* fix(create): add semantic-release plugins as devDependencies

---------

Co-authored-by: Caio Pizzol <caio@harbourshare.com>
Co-authored-by: semantic-release-bot <semantic-release-bot@martynus.net>
Co-authored-by: Caio Pizzol <97641911+caio-pizzol@users.noreply.github.com>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant